home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmVaCreateSimpleRadioBox.z / XmVaCreateSimpleRadioBox
Encoding:
Text File  |  2002-10-03  |  9.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx - A RowColumn widget convenience
  10.           creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/RowColumn.h>
  14.           WWWWiiiiddddggggeeeetttt XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx(
  15.           WWWWiiiiddddggggeeeetttt ppppaaaarrrreeeennnntttt,
  16.           SSSSttttrrrriiiinnnngggg nnnnaaaammmmeeee,
  17.           iiiinnnntttt bbbbuuuuttttttttoooonnnn____sssseeeetttt,
  18.           XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc ccccaaaallllllllbbbbaaaacccckkkk);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx creates an instance of a RowColumn
  25.           widget of type XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA and returns the associated widget
  26.           ID.  This routine uses the ANSI C variable-length argument
  27.           list (_v_a_r_a_r_g_s) calling convention.
  28.  
  29.           This routine creates a RadioBox and its ToggleButtonGadget
  30.           children.  The name of each button is bbbbuuuuttttttttoooonnnn_____n, where _n is
  31.           an integer from 0 (zero) to the number of buttons in the
  32.           menu minus 1.
  33.  
  34.           _p_a_r_e_n_t    Specifies the parent widget ID.
  35.  
  36.           _n_a_m_e      Specifies the name of the created widget.
  37.  
  38.           _b_u_t_t_o_n__s_e_t
  39.                     Specifies which button is initially set.  The
  40.                     value is the integer _n in the button name
  41.                     bbbbuuuuttttttttoooonnnn_____n.
  42.  
  43.           _c_a_l_l_b_a_c_k  Specifies a callback procedure to be called when a
  44.                     button's value changes.  This callback function is
  45.                     added to each button after creation as the
  46.                     button's XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk.  The callback
  47.                     function is called when a button's value changes,
  48.                     and the button number is returned in the
  49.                     _c_l_i_e_n_t__d_a_t_a field.
  50.  
  51.           The variable portion of the argument list consists of groups
  52.           of arguments.  The first argument in each group is a
  53.           constant or a string and determines which arguments follow
  54.           in that group.  The last argument in the list must be NULL.
  55.           Following are the possible first arguments in each group of
  56.           _v_a_r_a_r_g_s:
  57.  
  58.           XXXXmmmmVVVVaaaaRRRRAAAADDDDIIIIOOOOBBBBUUUUTTTTTTTTOOOONNNN
  59.                     This is followed by four additional arguments. The
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     set specifies one button in the RadioBox and some
  75.                     of its resource values. Following are the
  76.                     additional four arguments, in order:
  77.  
  78.                     _l_a_b_e_l     The label string, of type XXXXmmmmSSSSttttrrrriiiinnnngggg.
  79.  
  80.                     _m_n_e_m_o_n_i_c  The mnemonic, of type KKKKeeeeyyyySSSSyyyymmmm. This is
  81.                               ignored in this release.
  82.  
  83.                     _a_c_c_e_l_e_r_a_t_o_r
  84.                               The accelerator, of type SSSSttttrrrriiiinnnngggg. This is
  85.                               ignored in this release.
  86.  
  87.                     _a_c_c_e_l_e_r_a_t_o_r__t_e_x_t
  88.                               The accelerator text, of type XXXXmmmmSSSSttttrrrriiiinnnngggg.
  89.                               This is ignored in this release.
  90.  
  91.           _r_e_s_o_u_r_c_e__n_a_m_e
  92.                     This is followed by one additional argument, the
  93.                     value of the resource, of type _X_t_A_r_g_V_a_l. The pair
  94.                     specifies a resource and its value for the
  95.                     RowColumn widget.
  96.  
  97.           XXXXttttVVVVaaaaTTTTyyyyppppeeeeddddAAAArrrrgggg
  98.                     This is followed by four additional arguments. The
  99.                     set specifies a resource and its value for the
  100.                     RowColumn widget. A resource type conversion is
  101.                     performed if necessary. Following are the
  102.                     additional four arguments, in this order:
  103.  
  104.                     _n_a_m_e      The resource name, of type SSSSttttrrrriiiinnnngggg
  105.  
  106.                     _t_y_p_e      The type of the resource value supplied,
  107.                               of type SSSSttttrrrriiiinnnngggg
  108.  
  109.                     _v_a_l_u_e     The resource value (or a pointer to the
  110.                               resource value, depending on the type
  111.                               and size of the value), of type _X_t_A_r_g_V_a_l
  112.  
  113.                     _s_i_z_e      The size of the resource value in bytes,
  114.                               of type _i_n_t
  115.  
  116.           XXXXttttVVVVaaaaNNNNeeeesssstttteeeeddddLLLLiiiisssstttt
  117.                     This is followed by one additional argument of
  118.                     type _X_t_V_a_r_A_r_g_s_L_i_s_t. This argument is a nested list
  119.                     of _v_a_r_a_r_g_s returned by XXXXttttVVVVaaaaCCCCrrrreeeeaaaatttteeeeAAAArrrrggggssssLLLLiiiisssstttt.
  120.  
  121.           For more information on variable-length argument lists, see
  122.           the X Toolkit Intrinsics documentation.
  123.  
  124.           A number of resources exist specifically for use with this
  125.           and other simple menu creation routines.  For a complete
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX))))
  137.  
  138.  
  139.  
  140.           definition of RowColumn and its associated resources, see
  141.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3).
  142.  
  143.      RRRREEEETTTTUUUURRRRNNNN
  144.           Returns the RowColumn widget ID.
  145.  
  146.      RRRREEEELLLLAAAATTTTEEEEDDDD
  147.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRaaaaddddiiiiooooBBBBooooxxxx(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3),
  148.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx(3),
  149.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3), and XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx(3),
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.